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GitHub Cheat Sheet 


A collection of cool hidden and not so hidden features of Git and GitHub. This cheat sheet was inspired by Zach Holman's 
Git and GitHub Secrets talk at Aloha Ruby Conference 2012 (slides) and his More Git and GitHub Secrets talk at WOCNZ 
2013 (slides). 


Shortlink: http://git.io/sheet 


Read this in other languages: English, st 0], HAS, 4 AX. 
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GitHub 


Ignore Whitespace 


Adding ?w=1 to any diff URL will remove any changes only in whitespace, enabling you to see only that code that has 
changed. 


secrets.md 
secrets.md 





pe -3,4 +3,6 ËË 

Over the years we've added woe) oes Ê -4,3 +4,5 @8@ Over the y 

huge features, sometimes we 4 | huge features, sometimes ' 

= Let's talk about some o Let's talk about some 
5 +Let's talk about s + 

ni 


+## Whitespace 
3 +4 Whitespace 


Read more about GitHub secrets. 


Adjust Tab Space 


Adding ?ts=4 to a diff or file URL will display tab characters as 4 spaces wide instead of the default 8. The number after 
ts can be adjusted to suit your preference. This does not work on Gists, or raw file views. 


Here is a Go source file before adding ?ts=4: 


= file 69 lines (57 sloc} 1.66 kb i = Edit Raw Blame History Delete 
package flint 
import (| 
"paths filepath" 
) 
type lintError struct { 


Level int 
Message string 


..and this is after adding ?ts=4: 


= file 69 lines (57 sloc) 1.86 kb 
package flint 


import | 
"path/filepath" 


type lLintError struct { 
Level int 
Message string 


Commit History by Author 


To view all commits on a repo by author add ?author=username to the URL. 


https://github.com/rails/rails/commits/master?author=dhh 


P branch: master ~ | rails / Commits 


Apr 08, 2014 


L. Dont abbreviate that which needs no abbreviation 
dhh authored 6 days ago 


0 Dont encourage aliases now that we have variants 
dhh authored 6 days ago 


a Use short-form for the scaffold render calls and drop the needless test 
dhh authored 8&8 days ago 


Mar 21, 2014 


Update test helper to use latest Digestor API 
dhh authored a month ago 


dhh authored a month ago 


2 
[ Log the full path, including variant, that the digestor is trying to ... 
dhh authored a month ago 


i Digestor should just rely on the finder to know about the format and ... 
a Fix for digestor to consider variants for partials -- this still need... 
; dhh authored a month ago 


Read more about the differences between commits views. 


Cloning a Repository 


When cloning a repository the .git can be left off the end. 


$ git clone https://github.com/tiimgreen/github-cheat-sheet 


Read more about the Git clone command. 


Compare all Branches to Another Branch 


If you go to the repo's Branches page, next to the Commits button: 


https://github.com/{user}/{repo}/branches 


.. you would see a list of all branches which are not merged into the main branch. 


Edit 


Raw 


Blame 


History 


Delete 


304d2F19c8 + 


Browse code => 


1057OcfdSb + 


Browse code = 


| 4b0c8a9467 * | 


Browse code + 


Qd44b3f886 + 


Browse code + 


637bb/26ca + 


Browse code => 


4bea34750d + 


Browse code => 


B6b4fOlfca + 


Browse code = 


From here you can access the compare page or delete a branch with a click of a button. 


B ranc he S Recenti Active = Stale 


Showing 3 branches not merged into master. View merged branches. 





master my 
Last updated 3 days ago by mzgo. Base branch 
1.x-master 547 ahead ) 
Last updated 14 hours ago by mzgol. eer rer [=] Compare 
delegation 1 ahead = 
x” Last updated 4 months ago by timmywil. PETEA [Fl Compare 


1.9-stable p _ [=] Compare 
T43 behind 


Last updated a year ago by tomfuertes. 


However, often you need to compare branches to a branch other than master (€.g. development ). To do this, append the 
URL with the name of the branch like so: 


https://github.com/{user}/{repo }/branches/{branch} 


Branches . = 


Showing 2 branches not merged into 1.x-master. View merged branches. 


1.x-master 


Last updated 14 hours ago by magal. 





master 743 ahead 








+” Last updated 3 days ago by mzgol. = [+] Compare 
delegation 634 ahead 
Last updated 4 months ago by timmywil. sane [=] Compare 
To see the merged branches, append ?merged=1 to the URL. 
Branches = 


Recenti Active E E Stale 
Showing 1 branch merged into 1.x-master. View unmerged branches. 


1.x-master 


Last updated 14 hours ago by meg. 





1.9-stable 0 ahead 


Last updated a year ago by tomfuertes. PERE [=F Compare 


This view allows you to delete branches easily from the page, without using the command-line. 


Comparing Branches 


To use GitHub to compare branches, change the URL to look like this: 
https://github.com/user/repo/compare/{range} 


Where {range} = master...4-1-stable 


For example: 


https://github.com/rails/rails/compare/master...4-1-stable 


im U master ... P 4-1-stable Edit 


Please review the guidelines for contributing to this repository. 


Open a Pull Request for this comparison to discuss and review your changes with others. () 


247 commits 273 files changed 5 comments 36 contributors 
Commits Files changed Commit comments 


Feb 18, 2014 


‘@ dhh Update versions for 4.1.@.rcl x 
H dhh Revert “Update versions for 4.1.@.rcl" -- old format for versions! --- 

‘2 dhh Update versions for 4.1.@6.rcl Cusing new format) e 
2. arunagw Pointing README Links to 4-1-stable [ci skip] 

8) chancancode “rails new --edge” should use the ‘4-1-stable’ branch -- 

Ei chancancode Merge pull request #14100 from chancancode/rails_new_edge --- 


{range} can be changed to things like: 


https://github.com/rails/rails/compare/master@{1.day.ago}...master 
https://github.com/rails/rails/compare/master@{2014-10-04}...master 


Dates are in the format YYYY-DD-MM 


i ) master@{7@14-10-@4} ... master Edit 
130 commits 123 files changed 5 comments 39 contributors 
Commits Files changed Commit comments 


Aug 07, 2013 


Be emre-basala Add tests to ActiveSupport:XmlMini to_tag method al 


Nov 17, 2013 


® iantropov Fix insertion of records for hmt association with scope, fix #3548 x 


Jan 07, 2014 


pP roderickwd Auto-generate stable fixture UUIDs on PostgreSQL. = al 
..which allows you to see the difference on the master branch up a Set time ago or a specified date. 
Read more about comparing commits across time. 


Compare Branches across Forked Repositories 


To use GitHub to compare branches across forked repositories, change the URL to look like this: 


https://github.com/user/repo/compare/{foreign-user}:{branch}...{own-branch} 


For example: 


https://github.com/rails/rails/compare/byroot:master...master 


i P byroot:master ... PF ra.ils:master Edit 


Please review the guidelines for contributing to this repository. 
Open a Pull Request for this comparison to discuss and review your changes with others. 


6,802 commits 309 files changed 14 comments 64 contributors 
Commits Files changed Commit comments 


This comparison is big! We're only showing the most recent 250 commits 


Apr 02, 2014 


W) kastiglione PostgreSQL, Support for materialized views. [Dave Lee & Yves Senn] --- # de 
rajcybage We can conditional define the tests depending on the adapter or -- x 
= rafaelfranca Merge pull request #14565 from rajcybage/conditional_test_cases = s 
Ə rwz DRY AS: :SafeBuffer a bit using existing helper y" 
RE alexea Fixed small documentation typo - x 
£ rafaelfranca Merge pull request #14568 from alex88/patch-1 =- y 
Gists 
Gists are an easy way to work with small bits of code without creating a fully fledged repository. 
GitHub Gist Search... Discover Gists & rafaichmiel F &S | 
(6) timgreen / app.rb G - weStar o [Fork o 
Created 4 days ago 
A simple Ruby program. 
| Gist Detail app.rb Ruby @ | <? 


Revisions 1 1 puts ‘Hello World' 


cp Download Gist 


® rafalchmiel commented 2daysago # ® 
Clone this gist 


https: //gist.github Wow, dat is some engineering. 
Embed this gist 
<script src="https: 1 } 
es Write Preview Comments are parsed with GitHub Flavored Markdown 





Link to this gist 


https://gist.github Leave a comment 





Add .pibb to the end of any Gist URL (like this) in order to get the HTML only version suitable for embedding in any other 
Site. 


Gists can be treated as a full repository so they can be cloned like any other: 


$ git clone https://gist.github.com/tiimgreen/10545817 


Cloning into ‘10545817"... 

remote: Counting objects: 3, done. 

remote: Total 3 (delta 0), reused @ (delta @) 
Unpacking objects: 100% (3/3), done. 

Checking connectivity... done. 


Tims—MacBook-Pro:~ tim$ Ea 





Read more about creating gists. 


Git.io 


Git.io is a simple URL shortener for GitHub. 


cii AM http://git.io/AXNWKA [e357 4 Shorten another URL 





Terms of Service Privacy Security C) © 2014 GitHub Inc. All rights reserved. 


You can also use it via pure HTTP using Curl: 


$ curl -i http://git.io -F "url=https://github.com/..." 
HTTP/1.1 201 Created 
Location: http://git.io/abc123 


$ curl -i http://git.io/abc123 
HTTP/1.1 302 Found 
Location: https://github.com/... 


Read more about Git.io. 


Keyboard Shortcuts 
When on a repository page, keyboard shortcuts allow you to navigate easily. 


e Pressing t will bring up a file explorer. 


e Pressing w will bring up the branch selector. 

e Pressing s will select the Command Bar. 

e Pressing | will edit labels on existing Issues. 

e Pressing y when looking at a file (e.g. https://github.com/tiimgreen/github-cheat-sheet/blob/master/README.md ) will 
change your URL to one which, in effect, freezes the page you are looking at. If this code changes, you will still be 
able to see what you saw at that current time. 


To see all of the shortcuts for the current page press ?: 





Keyboard shortcuts 


Site wide shortcuts issues Pull request list 
Focus command bar, search all Submit comment Reply (quoting 
repositories selected text) 


kee Freeview comment 


Ho 


Focus command bar, search the op ktua Open issue 


current reposita ry 


aa eee O0 fullscreen 


: Cab Submit comment 
(Go to Notifications Sean 
tee = Freview comment 

Bri his help dial Create label 
ring up this he ialo 3 
g up i: : PEPTTSE Go fullscreen 
Back to issues 


Focus issues Search 


Move selection up Network Graph 


Scroll left 


a: 


Reply (quoting selected text) 


E 
E 
Move selection down 
k 
B 


Toggle selection 


Read more about using the Command Bar. 


Line Highlighting in Repositories 
Either adding #L52 to the end ofa code file URL or simply clicking the line number will highlight that line number. 


It also works with ranges, e.g. #L53-L60 , to select ranges, hold shift and click two lines: 


https://github.com/rails/rails/blob/master/activemodel/lib/active_model.ro#L53-L60 


autoload :Serialization 
autoload :TestCase 
autoload :Translation 
autoload :Validations 
autoload :Validator 


eager_autoload do 
autoload sErrors 
end 


module Serializers 
extend Activesupport: Autoload 


eager_autoload do 
autoload :J504 
autoload :xXm1 
end 
end 


def self.eager_load! 
super 
ActiveModel::S5erlalizers.eager load! 
end 
end 


Activesupport.on_load(:118n) do 
T1lgn.load path << File.dirname( FILE) + '/active_model/locale/en.ym1' 
end 


Closing Issues via Commit Messages 


Ifa particular commit fixes an issue, any of the keywords fix/fixes/fixed , close/closes/closed OF resolve/resolves/resolved , 


followed by the issue number, will close the issue once it is committed to the master branch. 


$ git commit -m "Fix screwup, fixes #12" 


This closes the issue and references the closing commit. 


A = (@) tlimgreen closed this issue from a commit 9 days ago 


[è] Fix screwup, fixes #12 


© [8] tiimgreen closed this in 36£4317 9 days ago 


Read more about closing Issues via commit messages. 


Cross-Link Issues 


If you want to link to another issue in the same repository, simple type hash # then the issue number, it will be auto- 
linked. 


To link to an issue in another repository, user_name/repo_name#ISSUE_NUMBER @.g. tiimgreen/toc#12 . 


We should probably handle this with github/enterprise#59 





(© sr referenced this issue in github/github October 14, 2011 





Pull Request #1773:Update footer for new formats Closed 


Cl Status on Pull Requests 


If set up correctly, every time you receive a Pull Request, Travis CI will build that Pull Request just like it would every time 
you make a new commit. Read more about how to get started with Travis Cl. 


c “ This repository ~ Search or type a command © Explore Gist Blog Help rafaichmiel +- X P 
octokit / octokit.rb @ Watch ~ 68  Unstar 1510 [f Fork 291 
Lazy create test repos #452 mr 
joeyw wants to merge 2 commits into master from lazy-create-test-re_ 
© 
s Conversation 0 © Commits 2 (Fy Files changed 1 ENESE +17 -0 ‘1 | 
Vv," joeyw commented a month ago Collaborator Labels Ap 
None yet 
Alternative to mass repo creation in #429 alt 
A ve : Milestone 
Checks for and creates test repositories before recording new cassettes. E 


No milestone 





Ey joeyw added some commits a month ago Assignee 
w Lazily create test repositories on new cassette recording Y No one assigned 
«w Ignore test repo setup interactions so they arent saved in cassettes md 
Notifications 
@ Subscribe 


v All is well — The Travis Cl build passed - Details 


You'll be notified when you 





participate or are 
@mentioned in this thread 


= Write Praview Comments are parsed with GitHub Flavored Markdown 


Read more about the commit status API. 


Syntax Highlighting in Markdown Files 


For example, to syntax highlight Ruby code in your Markdown files write: 


`` ruby 

require 'tabbit' 

table = Tabbit.new('Name'’, 'Email’) 
table.add_row('Tim Green’, 'tiimgreen@gmail.com') 
puts table.to_s 


This will produce: 


require 'tabbit' 

table = Tabbit.new('Name'’, 'Email’) 
table.add_row('Tim Green’, 'tiimgreen@gmail.com') 
puts table.to_s 


GitHub uses Linguist to perform language detection and syntax highlighting. You can find out which keywords are valid 
by perusing the languages YAML file. 


Read more about GitHub Flavored Markdown. 
Emojis 


Emojis can added to on Pull Requests, Issues, commit messages, Markdown files, etc. using :name_of emoji: : 
‘smile: 


Would produce: 

‘smile: 

The full list of supported Emojis on GitHub can be found at emoji-cheat-sheet.com or scotch-io/All-Github-Emoji-Icons. 
The top 5 used Ejmojis on GitHub are: 

‘Shipit: - :shipit: 

‘Sparkles: - :sparkles: 


"-1: - :-1: 


‘+1: - 241: 


ae ey FE 


‘Clap: - :clap: 


Images/GIFs 


Images and GIFs can be added to comments, READMEs etc.: 


I[Alt Text](http://www.sheawong.com/wp-content/uploads/2013/08/keephatin.gif) 





All images are cached on GitHub, so if your host goes down, the image will remain available. 


Embedding Images in GitHub Wiki 


There are multiple ways of embedding images in Wiki pages. There's the standard Markdown syntax (shown above). But 
there's also a syntax that allows things like specifying the height or width of the image: 


[[ http://www.sheawong.com/wp-content/uploads/2013/08/keephatin.gif | height = 100px J] 


Which produces: 


Home Pages History New Page 
<> 


Home (Preview) © 





README not found fsla 


T 


While a README isn't a required part of an open source project, it is a very good idea to have one. READMEs are a great place to describe 
your project or add some documentation such as how to install or use your project. You might want to include contact information - if your 
project becomes popular people will want to help you out. See GitHub's article on creating repositories. See Tom Preston-Werner's blog post X 
on README driven development. Also see the Wikipedia article on READMESs. 


Quick Quoting 


When on a comment thread and you want to quote something someone previously said, highlight the text and press r, 
this will copy it into your text box in the block-quote format. 





a 8 jakeboxer commented 2 minutes ago () 


Yep, | really like the second option—It puts exactly the right amount of emphasis on the content. 


k 





Write Preview Comments are parsed with GitHub Flavored Markdown 


im | 
Leave a comment or 


A 
at 


Attach images by dragging & dropping them or choose an image 


Read more about quick quoting. 


Quick Licensing 


When creating a repository GitHub gives you the options of adding in a pre-made license: 


O Initialize this repository with a README 
This will allow you to git clone the repository immediately. Skip this step if you have already run git 


Add .gitignore: None v Add a license: None v 


Licenses 


Create repository 
Filter licenses... 


GPL v2 





4# MIT License 





rms Privacy Security Contact 
Affero GPL 


You can also add them to existing repositories by creating a new file through the web interface. When the name LICENSE 
is typed in you will get an option to use a template: 


tiimgreen.github.io / LICENSE cancel Wai mplate? | Choose a license: None + 


License 


+” Apache v2 License 
GPL v2 
MIT License 
Affero GPL 
Artistic License 2.0 
BSD (3-Clause} License 
BSD 2-Clause license 
COCO 1.0 Universal 


Eclipse Public License v1.0 





Also works for .gitignore . 


Read more about open source licensing. 


Task Lists 


In Issues and Pull requests check boxes can be added with the following syntax (notice the space): 


- [ ] Be awesome 

-[ ] Prepare dinner 
-[ ] Research recipe 
-[ ] Buy ingredients 
-[ ] Cook recipe 

-[ ] Sleep 


TODO 


Oke) AlexandreArpin opened this issue just now - 0 comments 





i i AlexandreArpin commented just now 


Be awesome 


Prepare dinner 
Research recipe 


Buy ingredients 
Cook recipe 


Sleep 


When they are clicked, they will be updated in the pure Markdown: 


- [x] Be awesome 

- [ ] Prepare dinner 
- [x] Research recipe 
- [x] Buy ingredients 
- [ ] Cook recipe 

-[ ] Sleep 


Read more about task lists. 


Task Lists in Markdown Documents 


In full Markdown documents read-only checklists can now be added using the following syntax: 


- [ ] Mercury 
- [x] Venus 
- [x] Earth 
- [x] Moon 
- [x] Mars 
-[ ] Deimos 
-[ ] Phobos 


e | Mercury 


e I" Venus 








o | Deimos 
o | Phobos 








Read more about task lists in markdown documents. 


Relative Links 


Relative links are recommended in your Markdown files when linking to internal content. 


[Link to a header](#awesome-section) 
[Link to a file](docs/readme) 


Absolute links have to be updated whenever the URL changes (e.g. repository renamed, username changed, project 
forked). Using relative links makes your documentation easily stand on its own. 


Read more about relative links. 


Metadata and Plugin Support for GitHub Pages 


Within Jekyll pages and posts, repository information is available within the site.github namespace, and can be 
displayed, for example, using {{ site.github.project_title }}. 


The Jemoji and jekyll-mentions plugins enable emoji and @mentions in your Jekyll posts and pages to work just like 
you'd expect when interacting with a repository on GitHub.com. 


Read more about repository metadata and plugin support for GitHub Pages. 


Viewing YAML Metadata in your Documents 


Many blogging websites, like Jekyll with GitHub Pages, depend on some YAML-formatted metadata at the beginning of 
your post. GitHub will render this metadata as a horizontal table, for easier reading 


file | 61 lines (39 sloc) | 1.415 kb Edit Raw Blame History Delete 


layout title description tags path eventdate 
Git and GitHub Review Git and GitHub Review . classnotes/2013-02-13-NYU- 2013-02- 
bare for NYU for NYU notes | online | class github-class.md 13 


Your instructors for the evening are: 


e Matthew McCullough (Twitter, GitHub) 
e Tim Berglund (Twitter, GitHub) 


Read more about viewing YAML metadata in your documents. 


Rendering Tabular Data 


GitHub supports rendering tabular data in the form of .csv (comma-separated) and .tsv (tab-separated) files. 


file | 869 lines (868 sloc} 188.222 kb Edit Raw Blame History Delete 
Q Search this file. 

Title Release Year Locations Fun Facts Production Company 

180 2011 555 Market St. SPI Cinemas 

180 2011 Epic Roasthouse (399 Embarcade... SP! Cinemas 

160 2011 Mason & California Streets (Nob Hill) SPI Cinemas 

180 2011 Justin Herman Plaza SPI Cinemas 

180 2011 200 block Market Street SPI Cinemas 

180 2011 City Hall SP! Cinemas 

180 2011 Polk & Larkin Streets SPI Cinemas 

180 2011 Randall Musuem SPI Cinemas 

24 Hours on Craigslist 2005 Yerba Buena Productions 
48 Hours 1982 Paramount Pictures 

50 First Dates 2004 Rainforest Café (145 Jefferson Str... Columbia Pictures Corpora 
A Jitney Elopement 1915 Golden Gate Park During San Francisco's Gold Rush... The Essanay Film Manufact 
A Jitney Elopement 1915 20th and Folsom Streets The Essanay Film Manufact 
A Night Full of Rain 1978 san Francisco Chronicle (901 Mis... The San Francisco Zodiac Killer of... Liberty Film 


Read more about rendering tabular data. 


Diffs 


Rendered Prose Diffs 


Commits and pull requests including rendered documents supported by GitHub (e.g. Markdown) feature source and 
rendered views. 


SEQ88 rendered-prose-diffs.md >) B View 


+# Rendered Prose Ditts 
4 


+Today We are Making it easier to review and collaborate on prose documents. Commits and pull requests including 


Click the "rendered" button to see the changes as they'll appear in the rendered document. Rendered prose view is 


handy when you're adding, removing, and editing text: 


Also, notice that the URL uses the scope query parameter to define the scopes requested by the 
application. For our application, we're requesting user:email scope for reading private email 
addresses. 


Read more about rendered prose diffs. 


Diffable Maps 


Any time you view a commit or pull request on GitHub that includes geodata, GitHub will render a visual representation of 
what was changed. 


ra | TL M4. geo son ybe 


ae r r LA LALA a 


— iasa 








Addison 
| Northlake 


Glen Ellyn | Lombard Chicago 
Spckray 


Westmont 


A ea 


Revision Slider Highlight 


Read more about diffable maps. 


Expanding Context in Diffs 


Using the unfold button in the gutter of a diff, you can reveal additional lines of context with a click. You can keep clicking 
unfold until you've revealed the whole file, and the feature is available anywhere GitHub renders diffs. 


94 | += (RACSignal *)enqueueRequest: (NSURLRequest *)request fetchAll]lPages: (BOOL)fetchallPages: 
95 | + 

ii Enqueues a request to fetch information about the current user by accessing 

Ji a path relative to the user object. 

fi 


a T s LIE E q A idiin Ti bee ors wa | 0AE a a Looe 
fë -241,11 +255,13 #8 = (idjinitwithserver: (OCTServer *)jserver { 


NSString *userAgent = self.class.userAgent: 








if (userAgent != nil) [self setDefaultHeader: "User-Agent" value:userAgent | : 
243 | W 
244 = self.parameterEncoding = AFJSO0NParameterEncoding: 
245 = [self setDefaultHeader:@"Accept" value:@"application/vnd.github.beta+json" ]+ 
246 = 
[AFHTTPRequestūperation addAcceptablestatustCodes: [NSIndexSet indexsSetwithindex: OCTCLientNotModifiedstatuscCode | | 
248 =- [(AFJSONRequestOperation addAcceptableContentTypes:(NSSet setWithObject:@"application/vnd.github.beta+json"]]; 
259 | + 
260 | NSString *contentType = [NSString stringWithFormat: @"application/vnd.github.t@+json", OCTClientAPIVersion]; 
261 + [self setDefaultHeader:@"Accept" value:contentType];: 
262 + [AFJSONRequestOperation addAcceptableContentTypes:([NSSet setWithObject:contentType]]; 
263 | + 
264 + self.parameterEncoding = AFJSONParameterEncoding; 


[self registerHTTPOperationClass :AFISONRequestOperation.class]; 


return self: 


Read more about expanding context in diffs. 


Diff or Patch of Pull Request 


You can get the diff of a Pull Request by adding a .diff or .patch extension to the end of the URL. For example: 


https://github.com/tiimgreen/github-cheat-sheet/pull/15 
https://github.com/tiimgreen/github-cheat-sheet/pull/15.diff 
https://github.com/tiimgreen/github-cheat-sheet/pull/15.patch 


The .diff extension would give you this in plain text: 


diff --git a/README.md b/README.md 
index 88fcf69..8614873 100644 
--- a/README.md 
+++ b/README.md 
@@ -28,6 +28,7 @@ All the hidden and not hidden features of Git and GitHub. This cheat sheet was | 
- [Merged Branches](#merged-branches) 
- [Quick Licensing](#quick-licensing) 
- [TODO Lists](#todo-lists) 
+- [Relative Links](#relative-links) 
- [.gitconfig Recommendations](#gitconfig-recommendations) 
- [Aliases](#aliases) 
- [Auto-correct](#auto-correct) 
@@ -381,6 +382,19 @@ When they are clicked, they will be updated in the pure Markdown: 
-[ ] Sleep 


Rendering and diffing images 


GitHub can display several common image formats, including PNG, JPG, GIF, and PSD. In addition, there are several 
ways to compare differences between versions of those image formats. 





Read more about rendering and diffing images. 


Hub 


Hub is a command line Git wrapper that gives you extra features and commands that make working with GitHub easier. 


This allows you to do things like: 


$ hub clone tiimgreen/toc 


Check out some more cool commands Hub has to Offer. 


Decreasing Contributor Friction 


If you want people to use and contribute to your project, you need to start by answering their most basic questions. What 
does the project do? How do | use it? How am | allowed to use it? How do I contribute? How do | get up and running in 
development? How do | make sure my new features didn't break old functionality? 


Friction is a command line script that will check your project for common answers to these questions. This is some 
example output: 





Tims—MacBook-Pro:test tim$ friction 

ftest 
[ERROR] CONTRIBUTING guide not found (see htt .io/gq_ @mvQ) 
[ERROR] LICENSE not found (see htt . io/pFMOMQ) 
[ERROR] Bootstrap script not found (see htt .io/jZoRYA) 
[ERROR] Test script not found (see htt .io/oo?1Jw) 


[ERROR] .gitignore not found (see htt .io/pevikaA) 
Tims—MacBook-Pro:test tim$ fi 








Friction supports MRI 2.1.0, MRI 2.0.0, and MRI 1.9.3. 


Contributing Guidelines 


Adding a CONTRIBUTING file to the root of your repository will add a link to your file when a contributor creates an Issue or 
opens a Pull Request. 


Browse Issues Milestones Search: 


Please review the guidelines for contributing to this repository. 





Houston, we have a problem! 


Write Preview Comments are parsed with GitHub Flavored Markdown 


Read more about contributing guidelines. 


GitHub Resources 


Title Link 
GitHub Explore https://github.com/explore 
GitHub Blog https://github.com/blog 
GitHub Help https://help.github.com/ 
GitHub Training http://training.github.com/ 
GitHub Developer https://developer.github.com/ 
GitHub Talks 
Title Link 
How GitHub Uses GitHub to Build GitHub https:/www.youtube.com/watch?v=qyz3jkKOBbDQY 


Introduction to Git with Scott Chacon of GitHub httos:/Awww.youtube.com/watch?v=ZDR433b0HJY 


How GitHub No Longer Works https://www.youtube.com/watch?v=gXD1HWiZI 
Git and GitHub Secrets https:/www.youtube.com/watch?v=Foz9yvMkviA 


More Git and GitHub Secrets https:/www.youtube.com/watch?v=p50xsL-iVgU 


Git 


Previous Branch 


To move to the previous branch in Git: 


$ git checkout - 
# Switched to branch 'master' 


$ git checkout - 
# Switched to branch 'next' 


$ git checkout - 
# Switched to branch 'master' 


Read more about Git branching. 


Stripspace 
Git Stripspace: 


e Strips trailing whitespace 
e Collapses newlines 
e Adds newline to end of file 


A file must be passed when calling the command, e.g.: 


$ git stripspace < README.md 


Read more about the Git stripspace Command. 


Checking out Pull Requests 
Pull Requests are special branches on the GitHub repository which can be retrieved locally in several ways: 


Retrieve a specific Pull Request and store it temporarily in FETCH_HEAD for quickly diff ing or merge ing: 
$ git fetch origin refs/pull/[PR-Number]/head 

Acquire all Pull Request branches as local remote branches by refspec: 
$ git fetch origin '+refs/pull/*/head:refs/remotes/origin/pr/*' 


Or setup the remote to fetch Pull Requests automatically by adding these corresponding lines in your repository's 


.git/config : 


[remote "origin"] 
fetch = +refs/heads/*:refs/remotes/origin/* 
url = git@github.com:tiimgreen/github-cheat-sheet.git 


[remote "origin"] 
fetch = +refs/heads/*:refs/remotes/origin/* 
url = git@github.com:tiimgreen/github-cheat-sheet.git 
fetch = +refs/pull/*/head:refs/remotes/origin/pr/* 


For Fork-based Pull Request contributions, it's useful to checkout a remote branch representing the Pull Request and 
create a local branch from it: 


$ git checkout pr/42 pr-42 


Read more about checking out pull requests locally. 


Empty Commits :trollface: 


Commits can be pushed with no code changes by adding --allow-empty : 
$ git commit -m "Big-ass commit" --allow-empty 


Some use-cases for this (that make sense), include: 


Annotating the start of a new bulk of work or a new feature. 


Documenting when you make changes to the project that aren't code related. 


Communicating with people using your repository. 


The first commit of a repo, as the first commit cannot be rebased later: git commit -m "init repo" --allow-empty . 


Styled Git Status 


Running: 
$ git status 


Produces: 


= = —— m j m b. | mn : | : | 
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Wa i ’ ¥ =e i gn- = —— oe b= —_—_—_ b Pan ec a u = = 


| Tims-MacBook-Pro: ghħh-chea 
On branch master 
Your branch is up-to-date with ‘origin/master'’. 


t-—sheet tim$ git status 





Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout -- <file>..." to discard changes in working directory) 


modified: README . md 


no changes added to commit (use "git add" and/or "git commit -a") 
Tims-MacBook-Pro:ghħh-cheat-sheet tim$ p 


By adding -sb : 


$ git status -sb 


This is produced: 


Tims—MacBook-Pro:gh-cheat-sheet tim$ git status -sb 
## master...origin/master 

M README. md 
Tims-MacBook-Pro:gh-cheat-sheet tims P 





Read more about the Git status command. 


Styled Git Log 


Running: 


$ git log --all --graph --pretty=format:'%Cred%h%Creset -%C(auto)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abb 


Produces: 


Tims-MacBook-Pro:ghcs tim$ git log --all --graph --pretty=format: 'sCred&%h%Creset -%C(auto)%d%Creset %s %Cgreen(%cr) %C(bold blue)<*an>%Crese E 
t' --abbrev-commit --date=relative 

* ecf6946 - (HEAD, origin/master, origin/HEAD, master) Update CONTRIBUTING for translation contributions (5 days ago) <Tim Green> 

*  81f1c8 - Merge pull request #37 from hail2u/ja-translation (5 days ago) <Tim Green> 

1\ 

| * d6e4a83 - Add link to Japanese translation (5 days ago) <Kyo Nagashima> 

| * 3a95b5e - Add Japanese translation (5 days ago) <Kyo Nagashima> 


IZ 
* 84436d7 - Fix grammar (5 days ago) <Rafal Chmiel> 
9c52ecb - Merge pull request #35 from beausmith/patch-1 (5 days ago) <Rafal Chmiel> 


51cb710 - Adding example to Empty Commits (6 days ago) <Beau Smith> 
5063945 - Add link to Korean translation (5 days ago) <Rafal Chmiel> 


070a118 - Merge pull request #34 from marocchino/korean (5 days ago) <Tim Green> 


| 7632c28 - Update to 8753d95 (8 days ago) <Shim Tw> 
0ðc1a23 - Merge branch ‘master' into korean (8 days ago) <Shim Tw> 


S7cbdc® - Update to f1825eb (10 days ago) <Shim Tw> 
c@5cbe4 - Merge branch ‘master' into korean (10 days ago) <Shim Tw> 


| cbe8a04 - Update to 69da2b5 (11 days ago) <Shim Tw> 
951a3bb - Merge branch ‘master' into korean (11 days ago) <Shim Tw> 
YA 





Credit to Palesz 


This can be aliased using the instructions found here. 


Read more about the Git iog command. 


Git Query 


A Git query allows you to search all your previous commit messages and find the most recent one matching the query. 
$ git show :/query 


Where query (case-sensitive) is the term you want to search, this then finds the last one and gives details on the lines 
that were changed. 


$ git show :/typo 


eoo __j ghcs — less — 140x36 2 
i , : : ` ‘ i : s 
Tims-MacBook-Pro:ghcs tim$ git show :/typo 
commit e70c204e3d7cb154f5866b575d01c1dal4b6B8a6c 
Author: Rafal Chmiel <hi@rafalchmiel. com> 
Date: Mon Apr 14 12:37:57 2014 +0100 
Fix typo 
diff --git a/README.md b/README.md 
index 2bc494e..40022d2 100644 
=== a/README.md 
+++ b/README.md 
@@ -118,7 +118,7 @@ To see all of the shortcuts for the current page press `?`. 
## Closing Issues with Commits 


-If a particular commit fixes an issue, any of the keywords ‘fix/fixes/fixed* or ‘close/closes/closed’, followed by the issue number, will c 
+If a particular commit fixes an issue, any of the keywords ‘fix/fixes/fixed* or ‘close/closes/closed’, followed by the issue number, will c 


`` bash 
$ git commit -m "Fix cock up, fixes #12" 


Press q to quit. 


Merged Branches 


Running: 
$ git branch --merged 


Will give you a list of all branches that have been merged into your current branch. 


Conversely: 


$ git branch --no-merged 


Will give you a list of branches that have not been merged into your current branch. 


Read more about the Git branch command. 


Web Server for Browsing Local Repositories 


Use the Git instaweb Command to instantly browse your working repository in gitweb . This command is a simple script to 


setup gitweb and a web server for browsing the local repository. 


$ git instaweb 


Opens: 


projects / .git / summary 


summary | shortlog | log | commit | commitdiff | tree 





















































description Unnamed repository; edit this file 'description' to name the repository. 

owner Rafal Chmiel 

last change Mon, 14 Apr 2014 20:04:18 +0100 (20:04 +0100) 

shortlog 

2minago Rafal Chmiel Add use-cases for empty commits, thanks to @davej ... master] ongin/HEAD| originimaster| SOT! commiciit | tree | snapshot 
10 minago Tim Green Revert title back to original commit | commicitt | tree | snapshot 
12min ago Rafal Chmiel Add 'Git' to title commit | commitdift | tree | snaoshat 
15 min ago Rafal Chmiel Update contributing guide to fit new organization commit | commitdift | tree | snapshot 
17min ago Rafal Chmiel :star2: Organize sections (fixes #21) :star: commit | committat | tree | snapshot 
68 min ago Rafal Chmiel :star: Don't push, I'll be reorganizing the whole file commit | committi | tres | snapshot 
2 hours ago Tim Green Update intro paragraph commit | commiditt | tres | snapshot 
2 hours ago Tim Green Clarity Rendered Prose Diffs commit | commitditf | tree | snapshot 
3 hours ago Rafal Chmiel Add wiki images section under images/GIFs commit | commitdifi | tree | snapshot 
3 hours ago Rafal Chmiel Add 'Embedding Images in GitHub Wiki' section thanks... commit | commitift | tree | snapshot 
3 hours ago Rafal Chmiel Add info about '.pibb' thanks to @jballanc :heart: commit | commitdiff | tree | snapshot 
3 hours ago Rafal Chmiel Make list of emojis prettier commit | commitdift | tree | snaoshot 
3 hours ago Rafal Chmiel Just a little :trollface: commit | commitdiff | tree | snapshot 
4 hours ago Rafal Chmiel :trollface: :trollface: :trollface: commit | commitdit | tree | snapshot 
4 hours ago Rafal Chmiel Add ‘Contributing Guidelines' section :feelsgood: commit | commitdiff | tree 1 snapshot 
4 hours ago Rafal Chmiel Search bar -> command bar commit | commitdiff | tree | snapshot 
heads 


2min ago master 22ta i ka | ires 


remotes 


commit : 


| ? search: 


+++ git | 


Ore 


Read more about the Git instaweb command. 


Git Configurations 


Your .gitconfig file contains all your Git configurations. 


Aliases 
Aliases are helpers that let you define your own git calls. For example you could set gita to run git add --all . 


To add an alias, either navigate to ~/.gitconfig and fill it out in the following format: 


[alias] 
co = checkout 
cm = commit 
p = push 
# Show verbose output about tags, branches or remotes 
tags = tag -l 
branches = branch -a 
remotes = remote -v 


..or type in the command-line: 
$ git config --global alias.new_alias git_function 
For example: 


$ git config --global alias.cm commit 


For an alias with multiple functions use quotes: 


$ git config --global alias.ac ‘add -A . && commit’ 


Some useful aliases include: 


Alias Command What to Type 
git cm git commit git config --global alias.cm commit 
git co git checkout git config --global alias.co checkout 
git ac git add. -A git commit git config --global alias.ac '!git add -A && git commit’ 
git st git status -sb git config --global alias.st ‘status -sb' 
git tags git tag -l git config --global alias.tags ‘tag -l' 
git l i SR ; i en 
eee git branch -a git config --global alias.branches ‘branch -a 
git : À E ; r ee 
ae aT oe git remote -v git config --global alias.remotes ‘remote -v 
git log --color --graph -- git config --global alias.lg "log --color --graph -- 
itl pretty=format:'%Cred%h%Creset - pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset 
ae %C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold %s MCgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev- 
blue)<%an>%Creset' --abbrev-commit -- commit --" 


Some Aliases are taken from @mathiasbynens dotfiles: httos:/github.com/mathiasbynens/dotfiles/blob/master/.gitconfig 


Auto-Correct 


If you type git comit you will get this: 


$ git comit -m "Message" 
# git: 'comit'is not a git command. See ‘git --help'. 


# Did you mean this? 
# commit 


To call commit when comit is typed, just enable auto-correct: 


$ git config --global help.autocorrect 1 


So now you will get this: 


$ git comit -m "Message" 

# WARNING: You called a Git command named 'comit', which does not exist. 
# Continuing under the assumption that you meant 'commit' 

# in 0.1 seconds automatically... 


Color 


To add more color to your Git output: 


$ git config --global color.ui 1 


Read more about the Git config command. 


Git Resources 


Title 
Official Git Site 
Official Git Video Tutorials 


Code School Try Git 


Link 
http://git-scm.com/ 
http://git-scm.com/videos 


http://try.github.com/ 


Introductory Reference & Tutorial for Git http://gitref.org/ 


Official Git Tutorial 
Everyday Git 

Git Immersion 

Ry's Git Tutorial 

Git for Designer 

Git for Computer Scientists 
Git Magic 


GitHub Training Kit 


Git Books 


Title 


Pragmatic Version Control 
Using Git 


Pro Git 
Git Internals Peepcode 


Git in the Trenches 


Version Control with Git 


Pragmatic Guide to Git 


Git: Version Control for 
Everyone 


http://git-scm.com/docs/gittutorial 

http ://git-scm.com/docs/everyday 
http://gitimmersion.com/ 
http://rypress.com/tutorials/git/index.html 
http://noth.entp.com/output/git_for_designers.html 
http://eagain.net/articles/git-for-computer-scientists/ 
http:/Awww-cs-students.stanford.edu/~blynn/gitmagic/ 


http://training.github.comskit 


Link 


http:/Wwww.pragprog.com/titles/tsgit/pragmatic-version-control-using-git 


http://git-scm.com/book 
http://peepcode.com/products/git-internals-pdf 
http://cox33.github.com/gitt/ 


http:/Awww.amazon.com/Version-Control-Git-collaborative- 
development/dp/1449316387 


http:/Awww.pragprog.com/stitles/pg_git/pragmatic-guide-to-git 


http:/Awww.packtpub.com/git-version-control-for-everyone/book 


